v4.1.0

• #​2108 - failure listeners and fallback sinks (@​nblumhardt)
• #​2120 - add BatchingOptions.RetryTimeLimit and update retry scheduling algorithm (@​nblumhardt)

Important note

IBatchedLogEventSink batch retry scheduling has changed in this version. The default configuration still tries failed batches for approximately ten minutes, but the BufferingTimeLimit no longer implicitly causes the retry time to be extended or reduced. If you need a specific retry time, set BatchingOptions.RetryTimeLimit, which reliably controls retry time.

v4.0.2

• #​2094 - remove boxing and string allocations in output template formatting (@​epeshk)
• #​2103 - don't capture properties with private get accessors (@​nblumhardt)
• #​2095 - remove junk file (@​Numpsy)
• #​2116 - fall back to IDisposable in Log.CloseAndFlushAsync() when the target logger is not IAsyncDisposable (@​nblumhardt)

v4.0.1

• #​2090 — when capturing structured values, reuse HashSet instances, reduce LINQ usage, avoid reallocating string[] to improve performance and cut GC pressure (@​nblumhardt)
• #​2089 - allow capturing of non-anonymous structured values when trimming (@​nblumhardt)
• #​2083 - use Major.Minor.0.0 assembly versioning (@​nblumhardt)

v4.0.0

What's new in Serilog 4.0.0?

If you're deploying to .NET Framework, note that Serilog's assembly version number has been unpinned from the long-running historical 2.0.0 default, and now matches the package version precisely. If you encounter issues, ensure your build is generating valid assembly binding redirects.

Simple, robust, built-in batching support

Sinks that need batching functionality can now be easily written, without any additional package dependencies, by implementing IBatchedLogEventSink:

class MyBatchedSink: IBatchedLogEventSink
{
    public Task EmitBatchAsync(IReadOnlyCollection<LogEvent> batch)
    {
        // Send a batch of log events...
    }
}

Batched sinks can be added using WriteTo.Sink(IBatchedLogEventSink, ...) - they're given first-class consideration just like regular un-batched sinks.

The built-in batching implementation is based on System.Threading.Channels and draws on the original Serilog.Sinks.PeriodicBatching package (now in maintenance-mode), to provide a full-featured, efficient, async-native batching implementation.

Experimental dotted name capturing

By setting an experimental AppContext switch, message templates can be used to capture dotted names, which are required when using some logging schemas.

AppContext.SetSwitch("Serilog.Parsing.MessageTemplateParser.AcceptDottedPropertyNames", true);

Log.Information("Running as {user.name}", Environment.UserName);
// Captures {"user.name": "nblumhardt"}

While currently experimental and unsupported, this flag is intended to help the ecosystem evaluate and prepare for dotted name support in a future Serilog release.

Changes

• #​2015 — breaking unpin assembly version (@​nblumhardt)
• #​2045 — breaking use case-insensitive matching for level overrides (@​tillig)
• #​2051 — breaking recognize UtcTimestamp as a built-in token in output templates (@​MatthewHays)
• #​1979 — add tests for ReusableStringWriter (@​nblumhardt)
• #​2016 — update TFMs (@​nblumhardt, @​bartelink)
• #​2018 — add LogEvent.UnstableAssembleFromParts() (@​nblumhardt)
• #​2044 — build updates for compatibility (@​tillig)
• #​2027 — improve trimming annotations, compatibility switch for compiler-generated type support (@​agocke)
• #​2055 — introduce IBatchedLogEventSink and WriteTo.Sink(IBatchedLogEventSink) (@​nblumhardt)
• #​2060 — introduce LoggerSinkConfiguration.CreateSink() and redesign .Wrap() (@​nblumhardt, @​bartelink)
• #​2063 — improve MessageTemplateParser performance, switch to allow . in captured property names (@​nblumhardt)
• #​2064 — make message template alignment parsing match spec (@​Insomniak47)
• #​2065 — allow any character except } in message template format specifiers (@​Insomniak47)